home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 February / EnigmA AMIGA RUN 04 (1996)(G.R. Edizioni)(IT)[!][issue 1996-02][Skylink CD III].iso / earcd / util3 / idefix.lha / PlayCD.lha / PlayCD / PlayCD.doc < prev    next >
Text File  |  1995-02-06  |  12KB  |  379 lines
  1.  
  2. Welcome to PlayCD!!!
  3.  
  4. -----------------------------------------------------------------------------
  5.  
  6. LEGAL STUFF
  7.  
  8. PlayCD © Elaborate Bytes, Oliver Kastl
  9.  
  10.  
  11. All other rights reserved.
  12.  
  13.  
  14. -----------------------------------------------------------------------------
  15.  
  16.  
  17. GENERAL
  18.  
  19. PlayCD is a small but powerful player program for audio CDs.
  20. It will only work with SCSI-II, ATAPI and with Mitsumi CD-ROM drives.
  21. This program will refuse to work with Kickstart or Workbench versions
  22. below 2.04.
  23.  
  24.  
  25.  
  26. INSTALLATION
  27.  
  28. Use the supplied installation program to install PlayCD.
  29. PlayCD uses an own font for its display. However, if you don't want to copy
  30. the PlayCD font files to your fonts: directory, you may instruct the
  31. installation program to do so.
  32. PlayCD will look for the font specified in its tooltypes, where FONT=default
  33. will use the system's default font.
  34. If it can't find a specified font or you didn't specify one, it will use the
  35. screen font.
  36.  
  37.  
  38.  
  39. STARTING PLAYCD
  40.  
  41. Double-click on the program's icon to start.
  42. The program will get the proper device and unit number out of its ToolTypes.
  43. The installation program has entered the correct values here.
  44. Further it will read the "SKIP" value (The value how many seconds are
  45. "skipped" when you hit the SKIP FORWARD [>>] or BACK [<<] gadgets, see below)
  46. and PEEKTIME value (see the ToolType value PEEKTIME for details).
  47. When starting from the CLI, you must specify the proper device name und unit
  48. number. You may also specify the skip value.
  49. If you don't enter anything, PlayCD will default to DEVICE=tandemcd.device,
  50. UNIT=0, SKIP=1, screenfont, PEEKTIME=20.
  51.  
  52.  
  53.  
  54. ERRORS WHILE STARTING:
  55.  
  56. If the program refuses to start, there might be something wrong.
  57. For the most common errors during startup, an error message will be displayed:
  58.  
  59. "NO BOARD FOUND":
  60. The tandemcd.device refused to open, because it couldn't find the bsc tandem
  61. card. Please check the hardware installation! Check also the UNIT tooltype!
  62.  
  63. "CDROM NOT FOUND":
  64. The tandemcd.device refused to open, because it couldn't find the cdrom drive
  65. connected to a bsc tandem card. Probably it is not powered up. Please check
  66. the hardware installation and cabling! Check also the UNIT tooltype!
  67.  
  68. "OPEN DEVICE ERROR":
  69. The tandemcd.device couldn't be opened for some unknown reason.
  70. Please check the proper software installation! Use the installation program!
  71. Check also the DEVICE and UNIT tooltypes!
  72.  
  73.  
  74.  
  75.  
  76. QUITTING PLAYCD
  77.  
  78. To get rid of PlayCD you can:
  79.  
  80. 1. Hit the close gadget
  81. 2. Select "QUIT" from the menu Items
  82. 3. Use right-Amiga-key + Q from the keyboard
  83.  
  84. However, if the drive is already playing, it will continue playing linear
  85. from the current position until the end of the CD and then stop.
  86. If you restart PlayCD while audio is playing, PlayCD will not disturb the
  87. audio play. Nice, isn't it?
  88.  
  89.  
  90. DISPLAY
  91.  
  92. The Display shows you program status information.
  93. If a CD is inserted, the display shows:
  94.  
  95. No ss of tt
  96. xx:xx yy:yy
  97.  
  98. This means, the laser is currently at track number ss. On this CD are tt
  99. tracks available.
  100.  
  101. xx:xx is the time position from the beginning of the current track.
  102.  
  103. yy:yy is the time position from the beginning of the CD.
  104.  
  105. If no disc is inserted, the message "NO DISC" will be displayed.
  106.  
  107. Other possible messages are:
  108.  
  109.  
  110. HYBRID DISC:
  111. A hybrid disc (a disk capable to hold multiple sessions) is inserted.
  112. As there are no audio tracks on these discs, PlayCD will completely
  113. ignore them.
  114.  
  115.  
  116. TIME OUT:
  117. The CD-ROM didn't response to a command in the given amount of time.
  118. Very unlikely.
  119.  
  120. BAD STATUS:
  121. The drive returned bad status to a command. This should never happen.
  122.  
  123.  
  124. DATA TRACK:
  125. You tried to play or program a data track. This is not possible.
  126.  
  127.  
  128. READ ERROR:
  129. Error reading disc information or table of contents.
  130.  
  131.  
  132. PLEASE WAIT:
  133. Drive is busy, wait a moment.
  134.  
  135.  
  136. CLEAR SHUFFLE:
  137. Current shuffle play is cleared. This happens usually, if all tracks on a
  138. disc are played.
  139.  
  140.  
  141. CLEAR PROGRAM:
  142. Current program is cleared. This happens usually, if all programmed
  143. tracks on a disc are played.
  144.  
  145.  
  146. TABLE FULL:
  147. You cannot program more tracks, because the allocated memory is exhausted.
  148.  
  149.  
  150. NO TRACK:
  151. You tried to play or program a track, which does not exist.
  152.  
  153.  
  154. TRACK nn PROGRAMMED:
  155. An acknoledgement for you, that you have successfully programmed a track in
  156. PROGRAM mode.
  157.  
  158.  
  159.  
  160.  
  161. THE MENUES
  162.  
  163. MODE:
  164.  
  165. The menu item "MODE" configures PlayCD, which kind of play mode you wish to
  166. perform. The possible options are "CONTINUE", "PROGRAM", "SHUFFLE" and "TRACK".
  167.  
  168. The default mode is CONTINUE, when the program is started.
  169.  
  170. To change the play mode, simply activate one of the four subitems of MODE.
  171. You may also use the keyboard shortcuts right-Amiga-key and C,P,S or T.
  172. A checkmark left to the menu subitem shows the current mode.
  173. These modes are mutually exclusive.
  174.  
  175. Subitem CONTINUE:
  176. An Audio CD is played "linear". If the play operation is started, it will play
  177. all following tracks until the end of the CD.
  178.  
  179. Subitem PROGRAM:
  180. You can program different tracks. If you start the play operation by hitting
  181. the Play gadget, the PlayCD will play the tracks in the order you have entered
  182. them. You can either use the number gadgets to program the tracks, or the number
  183. keys on your keyboard. If you program via the keyboard please note that you have
  184. to enter 2 digits for each track (e.g. 02 for track 2), or 2 followed by enter.
  185. (See also "Keyboard shortcuts" later in this document).
  186.  
  187. Subitem SHUFFLE:
  188. In this mode, a random generator will choose the tracks that will be played.
  189.  
  190. Subitem TRACK:
  191. In this mode, only a single track will be played - playing will stop, after the
  192. track is finished.
  193.  
  194.  
  195. REPEAT:
  196. Enabling REPEAT will repeat play. This affects all modes described above:
  197. In "CONTINUE" mode, the whole CD will be played again and again.
  198. In "PROGRAM" mode, your programmed tracks will be repated.
  199. In "SHUFFLE" mode, the CD will be played randomly again and again.
  200. In "TRACK" mode, the single track you chose will be endlessly repeated.
  201. You may also use the keyboard shortcut right-Amiga-key and R to toggle Repeat.
  202. A checkmark left to the REPEAT item shows, if reapeat is active or not.
  203.  
  204.  
  205. INQUIRE:
  206. This menu item will give you verbose information about the exec device driver
  207. in use, the Unit number and the version of your CD-Rom drive
  208. You may also use the keyboard shortcut right-Amiga-key and I to pop up the
  209. information requester.
  210.  
  211. ABOUT:
  212. This menu item gives you information about the PlayCD program.
  213. You may also use the keyboard shortcut right-Amiga-key and A to pop up the
  214. information requester.
  215.  
  216.  
  217. QUIT:
  218. This will quit the program. It has the same function as hitting the close
  219. gadget. You may also use the keyboard shortcut right-Amiga-key and Q to quit.
  220.  
  221.  
  222.  
  223. THE GADGETS:
  224.  
  225. [|>]
  226. This is the PLAY gadget. It will start audio play from the beginning of
  227. the current track.
  228. In PROGRAM mode, it will start the play of your programmed tracks or,
  229. if already playing, seek to the next program step.
  230. In SHUFFLE mode, it will start the random play or, if already playing,
  231. play the next track in the "shuffle sequence". You can use "CURSOR DOWN"
  232. as a shortcut on your keyboard.
  233.  
  234. [|-|]
  235. This is the STOP gadget. It will stop the play and position the drive to track
  236. one. In PROGRAM mode, it will clear the running program. You can use "CURSOR
  237. UP" as a shortcut on your keyboard.
  238.  
  239. [||]
  240. This is the PAUSE gadget. It will pause audio play. Hitting it again will resume
  241. play at the position, where you paused. You may use the space bar on your
  242. keyboard as a shortcut.
  243.  
  244. [<<]
  245. This is the SKIP BACK gadget. You can use "CURSOR LEFT" as a shortcut on your
  246. keyboard. The value, how many seconds will be skipped can be specified via
  247. tooltypes or from the cli. Further you may use the slider gadget to directly
  248. skip to a position of the current track.
  249.  
  250. [>>]
  251. This is the SKIP FORWARD gadget. You can use "CURSOR LEFT" as a shortcut on
  252. your keyboard. The value, how many seconds will be skipped can be specified via
  253. tooltypes or from the cli. Further you may use the slider gadget to directly
  254. skip to a position of the current track.
  255.  
  256.  
  257. [|<<]
  258. This is the SEEK BACK gadget. It will seek to the track before the one currently
  259. playing and play this track immediately. In PROGRAM mode, it will SEEK BACK
  260. on program step. You can use "B" as a shortcut on your keyboard.
  261.  
  262. [>>|]
  263. This is the SEEK NEXT gadget. It will seek to the next track following the one
  264. currently playing and play this track immediately. In PROGRAM mode, it will
  265. go to the next program step. You can use "N" as a shortcut on your keyboard.
  266.  
  267. [^]
  268. This is the EJECT gadget. It will open/close the cd tray on Mitsumi FX001
  269. drives. With LU005 drives it is ghosted and inoperational.
  270. You can use "E" as a shortcut on your keyboard.
  271.  
  272. VOLUME SLIDER
  273. It will adjust the audio volume on Mitsumi FX001 drives. With LU005 drives it
  274. is ghosted and inoperational. It hast no keyboard shortcut.
  275.  
  276. [NUMBER]
  277. These gadgets are for direct playing/programming of tracks. Tracks greater as
  278. 20 must be entered via the keyboard.
  279. (See also "Keyboard shortcuts" later in this document).
  280.  
  281.  
  282.  
  283. KEYBOARD SHORTCUTS:
  284.  
  285. Most operations can be controlled with the keyboard.
  286. For these shortcuts to work, the PlayCD window must be active.
  287.  
  288.  
  289. GADGET SHORTCUTS:
  290.  
  291. CURSOR LEFT     = [<<]     (SKIP BACK)
  292. CURSOR RIGHT     = [>>]    (SKIP FORWARD)
  293. CURSOR DOWN     = [|>]    (PLAY)
  294. CURSOR UP         = [|-|]    (STOP)
  295. SPACE BAR         = [||]    (PAUSE/RESUME)
  296. B                    = [|<<]    (SEEK BACK)
  297. N                    = [>>|]    (SEEK NEXT)
  298. E              = [^]    (EJECT)
  299.  
  300. MENU SHORTCUTS:
  301.  
  302. Right Amiga key + C = Continue
  303. Right Amiga key + P = Program
  304. Right Amiga key + S = Shuffle
  305. Right Amiga key + T = Track
  306. Right Amiga key + R = Repeat
  307. Right Amiga key + I = Inquire
  308. Right Amiga key + A = About
  309. Right Amiga key + Q = Quit (same as hitting the close gadget)
  310.  
  311.  
  312. OTHER KEYBOARD OPERATIONS:
  313.  
  314. DEL                = Zip window (make it big or small)
  315. HELP                = run "sys:Utilities/AmigaGuide playcd.guide"
  316.  
  317. Instead of clicking on one of the number gadgets to play or progam a track,
  318. you may use the keyboard instead. This is very important to know, if you want
  319. to program track numbers greater than 20.
  320. To do this, simply enter the number on your keyboard, e.g. [2] and [1] for
  321. track 21. If you want to enter a track number below ten, you have to either
  322. enter a leading 0 (e.g. [0] and [5] for track 5), or enter [5] followed by
  323. the carriage return or the enter key.
  324. If you have entered a wrong first digit (e.g. you want to program track 21,
  325. but accidently typed 1 first), you can press backspace [<-] on our keyboard
  326. to erase the wrong entry (In our example this would be [1] oops! [<-]
  327. [2] [1]).
  328.  
  329.  
  330. TOOLTYPES
  331. Here are the tooltypes of the PlayCD.info file listed:
  332.  
  333. DEVICE=name.device
  334. Name of the exec.device driver. The Installation program should have filled
  335. in the correct name. Device names could be "tandemcd.device",
  336. "tandemcd_come.device" or "tandemcd_pcmcia.device". If no device name
  337. is given, the program defaults to "tandemcd.device".
  338.  
  339. UNIT=number
  340. Unit number of your driver. The Installation program should have filled
  341. in the correct unit number (usually 0).
  342. If no unit number is specified, the program defaults to unit 0.
  343.  
  344. DOSDEV=name
  345. You can also specify a DOS device name (e.g. CD0).
  346. If no DEVICE and UNIT tooltypes are specified, PlayCD will look for a mounted
  347. CD Rom drive with this DOS device name.
  348. Note that the DEVICE and UNIT tooltypes will override this!
  349.  
  350. SKIP=number
  351. Amount of seconds to skip when hitting SKIP FORWARD [>>] or SKIP BACK [<<] or
  352. their keyboard equivalents.
  353. If no value is specified, the program defaults to 1.
  354.  
  355. FONT=name
  356. Uses this font, if possible. Enter "default" for the system default font.
  357. If the specified font can't be loaded or if this tooltype is mising, PlayCD
  358. will use the current screen font.
  359.  
  360. FONTSIZE=number
  361. Size of your preferred font. If you want to use the system's default font size,
  362. enter 0 for the size.
  363.  
  364. PEEKTIME=number
  365. Interval (in 1/100 of a second), the drive will be asked for the current
  366. position during playback. Default is 20 (0,2 secs).
  367. Should never be higher than 100 (1 second) for proper operation.
  368. Lowering the value will make the "non-linear" playback modes (Track, Shuffle,
  369. Program) more accurate, but will use more CPU time.
  370.  
  371. PUBSCREEN=name
  372. The name of the public screen, you wish PlayCD to open its window.
  373. If this screen cannot be found or no screen is specified, the default public
  374. screen will be used.
  375.  
  376.  
  377. END OF DOCUMENT
  378.  
  379.